home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-1.iso / Files / Unstuff / Other Compression / UnzipMAc5.0.sit / Unzip 5.0p1 f / Source / funzip.1 < prev    next >
Encoding:
Text File  |  1993-01-23  |  1.9 KB  |  58 lines  |  [TEXT/MPS ]
  1. .TH FUNZIP 1 "19 Aug 92 (v1.3)"
  2. .SH NAME
  3. funzip \- extract from a ZIP archive file as a filter
  4. .SH SYNOPSIS
  5. [...]  |  \fBfunzip\fP [ password ]  |  [...]
  6. .SH ARGUMENTS
  7. .IP [\fIpassword\fP] \w'[\fIpassword\fP]'u+2m
  8. Optional password to be used if ZIP archive is encrypted.  Decryption
  9. may not be supported at some sites.  See DESCRIPTION for more details.
  10. .PD
  11. .SH DESCRIPTION
  12. .I FUnZip
  13. acts as a filter; that is, it assumes that a ZIP archive is being piped into
  14. standard input, and it extracts the first member from the archive to stdout.
  15. Given the limitation on single-member extraction, \fIFUnZip\fP is most
  16. useful in conjunction with a secondary archiver program such as tar(1).
  17. The following section includes an example illustrating this usage in the
  18. case of disk backups to tape.
  19. .PD
  20. .SH EXAMPLES
  21. To use \fIFUnZip\fP to extract the first member file of the archive test.zip
  22. and to pipe it into more(1):
  23. .PP
  24. .IP "\t\fIfunzip\fP < test.zip | more"
  25. .PP
  26. To use \fIFUnZip\fP to test the first member file of test.zip (any errors
  27. will be reported on standard error):
  28. .PP
  29. .IP "\t\fIfunzip\fP < test.zip > /dev/null"
  30. .PP
  31. To use \fIZip\fP and \fIFUnZip\fP in place of compress(1) and zcat(1) for
  32. tape backups:
  33. .PP
  34. .IP "\ttar cf \- . | \fIzip\fP \-7 | dd of=/dev/nrst0 obs=8k"
  35. .IP "\tdd if=/dev/nrst0 ibs=8k | \fIfunzip\fP | tar xf \-"
  36. .PP
  37. (where, for example, nrst0 is a SCSI tape drive).
  38. .PD
  39. .SH LIMITATIONS
  40. There is presently no way to extract any member but the first from a ZIP
  41. archive.  This would be useful in the case where a ZIP archive is included
  42. within another archive.
  43. .PP
  44. An alternate mechanism for passing the password to \fIFUnZip\fP would
  45. be preferable to putting it on the command line.
  46. .PP
  47. \fIFUnZip\fP would be useful under OS/2, too.
  48. .PP
  49. The functionality of \fIFUnZip\fP should be included in \fIUnZip\fP
  50. directly (future release).
  51. .PD
  52. .SH SEE ALSO
  53. unzip(1), zip(1), zipcloak(1), zipinfo(1), zipnote(1), zipsplit(1)
  54. .PD
  55. .SH AUTHOR
  56. Mark Adler (Info-ZIP)
  57. .PD
  58.